home *** CD-ROM | disk | FTP | other *** search
/ The Complete Windows Set / The Complete Windows Set.iso / CONVERT2 / CVTQ10A.TXT < prev   
Encoding:
Text File  |  1993-02-08  |  4.6 KB  |  128 lines
  1.                      CvtQuote 1.0a Documentation
  2.  
  3.  
  4.                    R.G. Brickner, CIS:[76530,1456]
  5.  
  6.  
  7.       TITLE:  Convert Fractional Securities Quotes to Decimal
  8.  
  9.  
  10.       KEYWORDS:  CONVERT QUOTE FRACTION DECIMAL WINDOWS DOS FILTER
  11.  
  12.  
  13. ABSTRACT:
  14.  
  15. CvtQuote is a simple but sophisticated program to convert securities quotes
  16. from fractional form to decimal form.  The input is assumed to consist
  17. of a standard DOS text file, most probably a capture or log file from an
  18. information service session, which contains securities quotes in fractional
  19. form.  The output is a DOS text file with the fractional amounts converted
  20. to decimal amounts. CvtQuote is supplied as both a Windows 3.1 application
  21. and as a DOS command-line application.  Version 1.0a allows "volume" data
  22. containing embedded commas.
  23.  
  24.  
  25. DESCRIPTION:
  26.  
  27. CvtQuote is a simple but sophisticated  program to convert securities quotes
  28. from fractional form to decimal form.  The input is assumed to consist
  29. of a standard DOS text file, most probably a capture or log file from an
  30. information service session, which contains lines of the form
  31.  
  32.    mm/dd/yy    v    i  i/i    i  i/i   i  i/i
  33.  
  34. where the date may or may not include leading zeroes, 'v' is the volume
  35. which may or may not contain embedded commas, and i is an integer.
  36. (For example:  Date, Volume, High/Ask Low/Bid Close/Avg).  The fractional
  37. part of the amounts need not exist;  CvtQuote handles equally well quotes
  38. of the form
  39.  
  40.    mm/dd/yy    v    i  i/i    i        i  i/i
  41.  
  42. and so on.  The output is in the form
  43.  
  44.    mm/dd/yy    v      i.ii      i.ii     i.ii
  45.  
  46. where the decimal forms of the amounts are the correct conversions from
  47. the fractional forms.  Lines which do not contain quotes of this form
  48. are copied unchanged to the output.  Note the parser also recognizes
  49. some quotes of the above form with extra embedded characters, so
  50. occasional 'noise' may not prevent the parser from recognizing these
  51. lines.
  52.  
  53. Only global replacement of lines of the above form is currently
  54. supported.  Other functionality, such as conversion of selected text or
  55. find-and-replace, could be implemented if there is a demand.
  56.  
  57. Do not convert a file twice - the results will not be what you want!
  58.  
  59. Both DOS and Windows 3.1 versions of the program are provided.
  60.  
  61.  
  62. INSTALLATION AND USAGE - WINDOWS 3.1 VERSION:
  63.  
  64. CvtQuote has been developed for Windows 3.1.  To install, uncompress the
  65. distribution file, and copy the Windows executable file 'CVTQ_W.EXE'
  66. to a suitable directory.  Add the executable as a new program item in a
  67. suitable group, or choose 'File/Run' from the Program Manager and fill in
  68. the path of CVTQ_W.EXE.  CVTQ_W.EXE will take a file name as a
  69. command-line argument.
  70.  
  71. Once you have started CvtQuote, it behaves much like a simple text
  72. editor such as Notepad. The quote conversion capability is accessed by
  73. means of the 'Edit/Convert All Quotes' menu item.  Choosing this menu item
  74. will convert all lines from fractional to decimal form.
  75.  
  76. CVTQ_W.EXE, the Windows version of this program, has a rather limited
  77. text-file capacity.  If that capacity is exceeded for a given file, it
  78. cannot recover the memory.  You must restart CvtQuote.  Ample warning
  79. dialogs are provided.  The DOS version of CvtQuote does not have these
  80. memory limitations.  You may use it in a DOS window or full-screen DOS
  81. session to convert large files.
  82.  
  83.  
  84. INSTALLATION AND USAGE - DOS VERSION:
  85.  
  86. CvtQuote has been developed for DOS 5.0, but it should work with most
  87. earlier versions of DOS.  To install, uncompress the distribution file,
  88. and copy the DOS executable file 'CVTQ.EXE' to a suitable directory
  89. which is included in your execution path.  The DOS version of CvtQuote
  90. runs in two modes, as a filter and with file name arguments.
  91.  
  92. CvtQuote as a filter:
  93.  
  94.   CVTQ < INFILE.TXT > OUTFILE.TXT
  95.  
  96. CvtQuote with command-line arguments:
  97.  
  98.   CVTQ   INFILE.TXT   OUTFILE.TXT
  99.  
  100. Any other usage will give you a usage hint.
  101.  
  102.  
  103. REVISION HISTORY:
  104.  
  105.  1/17/93    Original Version 1.0
  106.  2/ 8/93    Version 1.0a, adds ability to parse "volume" data containing
  107.             embedded commas.
  108.  
  109.  
  110. "LICENSE":
  111.  
  112. This software is provided mainly to see if anyone has a use for such
  113. things.  Your comments on the functionality and interface, and suggestions
  114. for extensions or improvements are actively sought.  Send EMAIL to
  115.  
  116.    CIS:[76530,1456]
  117.  
  118. However, if you find CvtQuote useful, it would be kind of you to make a
  119. small financial contribution:
  120.  
  121.    Send $5 to:
  122.  
  123.     R.G. Brickner
  124.     PO Box 9840
  125.     Santa Fe, NM 87504
  126.  
  127.                 CvtQuote is Copyright 1993 by R.G. Brickner
  128.